Commands for managing targets

Contents|Index|Previous|Next
Commands for managing targets

The following documentation discusses GDBs management of targets.

targettype parameters

Connects the GDB host environment to a target machine or process. A target is typically a protocol for talking to debugging facilities. You use the argument, type, to specify the type or protocol of the target machine.
Further parameters are interpreted by the target protocol, but typically include things like device names or host names to connect with, process numbers, and baud rates.
The target command does not repeat if you use Return again after executing the command.

help target

Displays the names of all targets available. To display targets currently selected, use either info target or info files (see Commands to specify files).

help target name

Describe a particular target, including any parameters necessary to select it.

set gnutargetargs

GDB uses its own library, BFD, to read your files. GDB knows whether it is reading an executable, a core, or a `.o` file; however you can specify the file format with the set gnutarget command.
Unlike most target commands, with gnutarget, the target refers to a program, not a machine.

Warning:
To specify a file format with set gnutarget, you must know the actual BFD name. See Commands to specify files.

show gnutarget

Use the show gnutarget command to display what file format gnutarget is set to read. If you have not set gnutarget, GDB will determine the file format for each file automatically and show gnutarget displays, The current BDF target is "auto". as output.

The following are some common targets (available, or not, depending on the GDB configuration).

target execprogram

An executable file. ‘target exec program’ is the same as ‘exec-fileprogram’.

target corefilename

A core dump file. ‘target core filename’ is the same as ‘core-filefilename’.

target remotedev

Remote serial target in GDB-specific protocol. The argument, dev, specifies what serial device to use for the connection (e.g., ‘/dev/ttya’). See Remote debugging. target remote now supports the load command. This is only useful if you have some other way of getting the stub to the target system, and you can put it somewhere in memory where it won’t get clobbered by the download.

targetsim

CPU simulator. See Simulated CPU target.

target udikeyword

Remote AMD29K target, using the AMD UDI protocol. The keyword argument specifies which 29K board or simulator to use. See The UDI protocol for AMD29K.

target amd-ebdev speedPROG

Remote PC-resident AMD EB29K board, attached over serial lines. dev is the serial device, as for target remote; speed allows you to specify the linespeed; and PROG is the name of the program to be debugged, as it appears to DOS on the PC. See The EBMON protocol for AMD29K.

target hms dev

A Hitachi SH, H8/300, or H8/500 board, attached via serial line to your host. Use special commands, device and speed, to control the serial line and the communications speed used. See GDB and Hitachi Microprocessors.

target nindydevicename

An Intel 960 board controlled by a Nindy Monitor. device-name is the name of the serial device to use for the connection, e.g. ‘/dev/ttya’. See GDB with a remote i960 (Nindy).

target st2000dev speed

A Tandem ST2000 phone switch, running Tandem’s STD-BUG protocol. dev is the name of the device attached to the ST2000 serial line; speed is the communication line speed. The arguments are not used if GDB is configured to connect to the ST2000 using TCP or Telnet. See GDB with a Tandem ST2000.

target vxworksmachinename

A VxWorks system, attached via TCP/IP. The argument, machinename, is the target system’s machine name or IP address. See GDB and VxWorks.

target cpu32bugdev

CPU32BUG monitor, running on a CPU32 (M68K) board.

target op50ndev

OP50N monitor, running on an OKI HPPA board.

target w89kdev

W89K monitor, running on a Winbond HPPA board.

target estdev

EST-300 ICE monitor, running on a CPU32 (M68K) board.

target rom68kdev

ROM 68K monitor, running on an IDP board.

target arraydev

Array Tech LSI33K RAID controller board.

target sparclitedev

Fujitsu SPARClite boards, used only for the purpose of loading. You must use an additional command to debug the program (for example, use target remote dev for GDB standard remote protocol. Different targets are available on different configurations of GDB; your configuration may have more or fewer targets.

Top|Contents|Index|Previous|Next